install.htmlTEXTMSIE≠CπHÀ:πHÀ:ÅÅ˚" UnlimitedFTP Demo
Unlimi-Tech Website Unlimited FTP Website

 

UnlimitedFTP has more than 60 customizable parameters. Using UnlimitedFTP's parameters, you can create fully customized, simple to use, file transfer solution for your users. UnlimitedFTP also includes secure FTP capabilities, please review SecureFTPInstall.txt for more details. To customize UnlimitedFTP, you must edit "uftpscript.js" with an HTML/text editor. You can then use the following tables as a guide to customizing each of UnlimitedFTP's parameters.

Then add the following line to your HTML file:

<script language="javascript" src="uftpscript.js"></script>

You must also make sure that you either put uftpscript.js in the same directory as your page, or the src parameter reflects the location of the script file.

If you are a personal user, and are looking for a simple way to manage your FTP connections, you should visit www.unlimitedftp.ca. This free service integrates UnlimitedFTP for you, and allows you to manage all your FTP accounts from one web site.

If you require further assistance with setup, or are interested in related products and customization services, please visit our website.

Please also review the Readme and License files.

Connection related settings
server

The host name or IP address of the FTP server.

Default value: ""
Valid values: "<valid hostname or IP address>"

port

The port number of the FTP server. Usually the default FTP port is 21.

Default value: "21"
Valid values: "<valid port number>"

pass

The password for the FTP server account.

Default value: ""

user

The username for the FTP server account.

Default value: ""

passive

If set to "true", all data connections will be outgoing. UnlimitedFTP works through firewalls when this value is set to "true". If you are using an FTP proxy, set this value to "false".

Default value: "true"
Valid values: "true", "false"

autoconnect

If this value is set to "true", UnlimitedFTP will automatically connect based on the connection credentials supplied in the above parameters. The default value is "false".

Default value: "false"
Valid values: "true", "false"

autoreconnect

If this value is set to "true", UnlimitedFTP will automatically ask the user if they would like to reconnect after a time-out has occurred, or they have been disconnected for some other reason. If "autoconnect" is set to true, it will log them directly in to the server. If not, the user will be presented with the Connect dialog, pre-populated with the connection info.

Default value: "true"
Valid values: "true", "false"

encrypt

If set to "true" you must pass encrypted user/pass/server parameters to UnlimitedFTP, which will decrypt them and perform the login. The encryption is based on a key value that is specified by the "ek" parameter below. To encrypt parameters you can use encrypt.html that was downloaded with UnlimitedFTP. This provides at least some measure of protection from prying eyes, and people who love to snoop through your HTML.

Although this seems very un-secure to include the encryption algorithm along with the applet, keep in mind this is only a way to hide login credentials from users who try to view the HTML source of your page. Determined hackers will easily be able to sniff the network to retrieve user and password info regardless of the encryption done in the HTML.

Default value: "false"
Valid values: "true", "false"

ek

This parameter works in conjunction with the "encrypt" parameter. This is the key that is used to encode/decode the string value you pass to the user, pass, and server parameters. Here is an example configuration. In this example, the server/user/pass strings are 192.168.1.100/anonymous/uftp@unlimitedftp.com respectively. This illustrates how the parameters will look to anyone who inspects the connection values in your HTML:

var server = "8I7BLHN;8I8@5";
var port = "21";
var pass = "|vy&[)&yp*p&jx#((;j,t";
var user = "h~t$6!=$z";
var autoconnect = "true";
var autoreconnect = "true";
var passive = "true";
var encrypt = "true";
var ek = "encryptkey";

Default value: ""
Valid values: "<string value>"

connecttimeout

This value (in milliseconds) specifies how long UnlimitedFTP will try to connect to an FTP server before giving up and timing out.

Default value: "20000"
Valid values: "<integer value>"

sotimeout

This value (in milliseconds) specifies how long a data connection will wait to read data before giving up and timing out.

Default value: "-1" means no timeout
Valid values: "<integer value>"

useSerfo

If set to true, UnlimitedFTP will attempt to open an FTP connection through the Service Forwarding Agent at the URL specified by the "SerfoLocation" parameter below.

Default value: "false"
Valid values: "true", "false"

SerfoLocation

The location of the Service Forwarding Agent servlet. Please consult SecureFTPInstall.txt for more information.

Default value: ""
Valid values: "<valid URL>"

 

Proxy server related settings. (Internet Explorer Only)
autodetectproxy

If this value is set to "true", UnlimitedFTP will automatically attempt to detect Internet Explorer's Proxy setup and use it when connecting to FTP servers. This will detect both SOCKS 4 proxy settings, and FTP proxy settings.

Default value: "false"
Valid values: "true", "false"

socksproxy

If this value is set to "true", UnlimitedFTP will use the SOCKS proxy server and port specified by the "socksProxyHost" and "socksProxyPort" parameters.

Default value: "false"
Valid values: "true", "false"

socksProxyHost

SOCKS proxy server location.

Default value: ""
Valid values: "<valid hostname or IP address>"

socksProxyPort

SOCKS proxy server port.

Default value: ""
Valid values: "<valid port number>"

ftpproxy

If this value is set to "true" and socksproxy is set to "false", UnlimitedFTP will use the FTP proxy server and port specified by the "ftpProxyHost" and "ftpProxyPort" parameters.

Default value: "false"
Valid values: "true", "false"

ftpProxyHost

FTP proxy server location.

Default value: ""
Valid values: "<valid hostname or IP address>"

ftpProxyPort

FTP proxy server port.

Default value: ""
Valid values: "<valid port number>"

 

Functionality related settings

ascbin

Can be either "asc","bin" or "auto", you can set the default file transfer mode. When this parameter is set to auto, UnlimitedFTP will set the transfer mode automatically by comparing the file extension to the list of file extensions specified in the "asciiextensions" parameter below.

Default value: "bin"
Valid values: "bin", "asc", "auto", and "macbin"(MacOS only)

showascbin

If this value is set to "true", UnlimitedFTP will hide the ASCII/BINARY or TEXT/DATA/MACBINARY radio buttons.

Default value: "false"
Valid values: "true", "false"

asciiextensions

Transfer all the files with these extension in Ascii Mode. Used in conjunction with "ascbin" parameter when it is set to "auto".

Default value: ""
Valid values: "<comma delimited list of extensions>"

extensions

Only files with these extensions will be displayed/affected by UnlimitedFTP.

Default value: ""
Valid values: "<comma delimited list of extensions>"

lockinitialdir

If set to "true", UnlimitedFTP locks the user to the initial directory, and its sub-directories.

Default value: "false"
Valid values: "true", "false"

localdir

UnlimitedFTP will automatically switch to this local directory when UnlimitedFTP initializes. Example would be "c:\windows" or "/etc".

Default value: ""
Valid values: "<valid local directory>"

remotedir

UnlimitedFTP will automatically switch to this directory on the FTP server after a successful login. Example would be "/initialdir".

Default value: ""
Valid values: "<valid remote directory>"

enableCookies

UnlimitedFTP will store cookies to remember the last site and username if this value is set to "true".

Default value: "true"
Valid values: "true", "false"

doubleClickTransfer

If this value is set to "true", double clicking on a file will initiate a transfer of the selected file(s).

Default value: "true"
Valid values: "true", "false"

enablerightclick

If this value is set to false, users will not be able to right click on files and execute the available options for that file.

Default value: "true"
Valid values: "true", "false"

helpLocation

When the "Help" button is pressed, it will open a new browser window and is sent to the URL specified.

Default value: ""
Valid values: "<valid URL>"

syncpriority

While using the "Sync" button, if a file exists on both the local and remote file system, this parameter determines which file is considered to be the master file. The other file will be overwritten. If the value is set to "local", any remote file that exists on the local side as well, will be overwritten by the local version.

Default value: "local"
Valid values: "local", "remote"

incremental

If files have not been modified they will not be transferred. This is determined by comparing the size of the files, and optionally the date/time of modification of the files. If you want to use date/time you must set the "incdatetime" to "true".

Default value: "false"
Valid values: "true", "false"

incdatetime

When doing incremental transfers, this parameter determines whether to use a date/time stamp to compare files. This is optional because the date/time stamp can vary greatly between the local time on your PC and the time on the FTP server. For this reason, when using this feature, you should also use the "timezonecomp" parameter to compensate for differences in time between the local and remote file systems.

Default value: "false"
Valid values: "true", "false"

timezonecomp

A value in minutes that specifies a time difference between the local file system, and the remote file system. For example, is you are in the New York, and you are connecting to a an FTP server in Los Angeles, you would set this value to -180 to compensate for the time difference because LA is 3 hours (180 minutes) behind NY time. Conversely, if the FTP server is located in NY and you are in LA, the value should be set to 180 because NY is three hours ahead.

Default value: "0"
Valid values: <integer value in minutes>

selectalllocal

All files in the initial local directory will be selected when UnlimitedFTP initializes.

Default value: ""
Valid values: "<valid local directory>"

selectallremote

All files in the initial remote directory will be selected when UnlimitedFTP connects successfully to an FTP server.

Default value: ""
Valid values: "<valid remote directory>"

autoupload

Used in conjunction with "selectalllocal", this parameter allows you to automatically upload files. This parameter is only functional when UnlimitedFTP is licensed.

Default value: "false"
Valid values: "true", "false"

autodownload

Used in conjunction with "selectallremote", this parameter allows you to automatically download files. This parameter is only functional when UnlimitedFTP is licensed.

Default value: "false"
Valid values: "true", "false"

autoallo Default value: "false"
Valid values: "true", "false"
createdirectoryonconnect

This param specifies a remote directory that should be created when an FTP connection is established.

Default value: ""
Valid values: "<valid remote directory>"

 

Color related settings

background

Allows you to change the background of the applet using standard RGB (Red, Green, Blue) values separated by a comma. For example white = 255,255,255

Default value: "255,255,255"
Valid values: "<valid RGB values between 0 and 255>"

buttonTextColorOnMouseOver

The color of the text on the buttons when the mouse moves over them.

Default value: "255,255,255"
Valid values: "<valid RGB values between 0 and 255>"

buttonTextColor

The color of the text on the buttons.

Default value: "0,0,0"
Valid values: "<valid RGB values between 0 and 255>"

buttonColorOnMouseOver

The background color of the buttons when the mouse moves over them.

Default value: "10,50,10"
Valid values: "<valid RGB values between 0 and 255>"

buttonbackground

The background color of the buttons.

Default value: "81,132,81"
Valid values: "<valid RGB values between 0 and 255>"

headerTextColor

The color of the local and remote list headers

Default value: "0,0,255"
Valid values: "<valid RGB values between 0 and 255>"

drivesForegroundColor

The color of the drive selection combo box text in the Windows version of UnlimitedFTP.

Default value: "0,0,0"
Valid values: "<valid RGB values between 0 and 255>"

drivesBackgroundColor

The color of the drive selection combo box background in the Windows version of UnlimitedFTP.

Default value: "255,255,255"
Valid values: "<valid RGB values between 0 and 255>"

ascBinTextColor

The ASCII/BINARY (Windows/Unix) and TEXT/DATA/MACBINARY (Mac) radio buttons text.

Default value: "0,0,0"
Valid values: "<valid RGB values between 0 and 255>"

 

Interface and Layout related settings
language

UnlimitedFTP allows you to customize the language of the text on the interface. To do this, edit the contents of "lang_en.txt" which is included in the download archive. Save the file with an appropriate language code. Example for French might be "lang_fr.txt". This parameter should then be set to "fr".

Default value: "en"
Valid values: "<language code>" - There must also be a file defined lang_<language code>.txt in the same directory as unlimitedftp.jar, and unlimitedftp.cab.

classicfilelist

UnlimitedFTP uses a custom file list that is sometimes slow on some platforms. If this becomes a problem, this value should be set to "true" and UnlimitedFTP will use a simplified file list with no icons or graphics.

Default value: "false"
Valid values: "true", "false"

LocalOptions

If this value is set to "false" all of the local buttons will become invisible.

Default value: "true"
Valid values: "true", "false"

RemoteOptions

If this value is set to "false" all of the remote buttons will become invisible.

Default value: "true"
Valid values: "true", "false"

display

If this value is set to "false" the FTP message display will become invisible.

Default value: "true"
Valid values: "true", "false"

showhelpbutton

Setting this value to "false" will hide the "Help" button

Default value: "true"
Valid values: "true", "false"

showputbutton

Setting this value to "false" will hide the "Upload" button

Default value: "true"
Valid values: "true", "false"

showgetbutton

Setting this value to "false" will hide the "Download" button

Default value: "true"
Valid values: "true", "false"

showsyncbutton

Setting this value to "false" will hide the "Sync" button

Default value: "true"
Valid values: "true", "false"

showaboutbutton

Setting this value to "false" will hide the "About" button

NOTE: This parameter will only work if you have a licensed version of Unlimited FTP

Default value: "true"
Valid values: "true", "false"

showlocallist

Setting this value to "false" will hide the local file list and all of the local buttons

Default value: "true"
Valid values: "true", "false"

showremotelist

Setting this value to "false" will hide the remote file list and all of the remote buttons

Default value: "true"
Valid values: "true", "false"

remoteheader

Specifies the text to display above the remote file list when connected to an FTP server.

Default value: The hostname or IP of the remote server
Valid values: "Any text you want"

width Default value: "600"
Valid values: "<integer value (in pixels)>"
height Default value: "480"
Valid values: "<integer value (in pixels)>"

 

Customizable Error Pages
errNavWin

This error page will be called when the user is running Windows, and their Netscape version is not sufficient to run UnlimitedFTP.

Default value: ""
Valid values: "<valid URL>"

errIEWin

This error page will be called when the user is running Windows, and their Internet Explorer version is not sufficient to run UnlimitedFTP.

Default value: ""
Valid values: "<valid URL>"

errIEWinVM

This error page will be called when the user is running Windows with Internet Explorer and the Microsoft VM for Java is not sufficient to run UnlimitedFTP.

Default value: ""
Valid values: "<valid URL>"

errNavUnix

This error page will be called when the user is running Unix, and their Netscape version is not sufficient to run UnlimitedFTP.

Default value: ""
Valid values: "<valid URL>"

errIEMac

This error page will be called when the user is running Mac OS, and their Internet Explorer version is not sufficient to run UnlimitedFTP.

Default value: ""
Valid values: "<valid URL>"

errNavMac

This error page will be called when the user is running Mac OS, and their Netscape version is not sufficient to run UnlimitedFTP.

Default value: ""
Valid values: "<valid URL>"

errOperaWin

This error page will be called when the user is running Opera browser, and the version is not sufficient to run UnlimitedFTP.

Default value: ""
Valid values: "<valid URL>"

rejectPermissionURL

This error page will be called when the user rejects the security certificate or does not grant the permissions required for UnlimitedFTP to run.

Default value: ""
Valid values: "<valid URL>"

This resource fork intentionally left blank ˇˇ